.. _ceaiDigit_Get:

ceaiDigit_Get
=============
-------------




SYNOPSIS
--------


.. code-block:: none

  VT_I4 ceaiDigit_Get(
    VT_I4 Channel,
    VT_PI4 Digit
  )



DESCRIPTION
-----------


- 설정된 전압 범위에 해당하는 모드를 반환 합니다.



PARAMETER
---------


- Channel : 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero Based). 이상, (최대 통합 채널수 - 1) 이하의 값을 채널 번호로 설정할 수 있습니다. 

- Digit : 이 매개변수를 통하여 A/D 결과값을 Digit 값으로 반환합니다. 13Bit Straight Binery. (0~8192)로 구성되어 있습니다. . 

.. warning::
  단, 전압 입력 범위(Range) 모드가 5 번 모드(1~5V), 6 번 모드(1~5V, 4~20mA)

  모드인 경우는 입력 전압이 1V 보다 낮은 경우, Digit 값으로 구분해서 표시하기

  위해 Digit 값과 Voltage 값의 관계 직선에서 0~1V 에 해당되는 음의 Digit 값을

  선형적으로 계산해서 반환합니다.


RETURN VALUE
------------


+----------------+-------------------------------------------------------+
| Value          | Meaning                                               |
+================+=======================================================+
| 음수           | 수행 실패. 자세한 내용은 '에러 처리' 편을 참고합니다. |
+----------------+-------------------------------------------------------+
| 0 (ceERR_NONE) | 수행 성공                                             |
+----------------+-------------------------------------------------------+



Example
-------
.. code-block:: cpp
 :linenos:
 C/C++
 #include “ceSDK.h”
 #include “ceSDKDef.h”
 long nAiChNo = 1; // 아날로그 입력 채널
 long nDigitVal; // A/D 결과를 Digit 값으로 반환
 // 전압 입력 모드를 3 번 (0~10V, 0 ~ 20mA) 로 설정
 ceaiVoltRangeMode_Set ( nAiChNo, 3 );
 // A/D 결과값을 Digit 값으로 반환합니다.
 if ( ceaiDigit_Get ( nAiChNo, &nDigitVal ) != ceERR_NONE )
 {
 OutputDebugString ( "ceaiDigit_Get has been failed" );
 }